home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / wais / waisgate / wprot.c < prev    next >
C/C++ Source or Header  |  1995-05-09  |  69KB  |  2,454 lines
  1. /* WIDE AREA INFORMATION SERVER SOFTWARE:
  2.    No guarantees or restrictions.  See the readme file for the full standard
  3.    disclaimer.    
  4.   
  5.    3.26.90    Harry Morris, morris@think.com
  6.    3.30.90  Harry Morris 
  7.    -    removed chunk code from WAISSearchAPDU,
  8.    -    added makeWAISQueryType1Query() and readWAISType1Query() which replace
  9.    makeWAISQueryTerms() and makeWAISQueryDocs().
  10.    4.11.90  HWM - generalized conditional includes (see c-dialect.h)
  11.    - renamed makeWAISType1Query() to makeWAISTextQuery()
  12.    renamed readWAISType1Query() to readWAISTextQuery()
  13.    5.29.90  TS - fixed bug in makeWAISQueryDocs
  14.    added CSTFreeWAISFoo functions
  15. */
  16.  
  17. #ifndef lint
  18. static char *RCSid = "$Header: /tmp_mnt/net/quake/proj/wais/wais-8-b5/ir/RCS/wprot.c,v 1.8 92/04/02 14:20:58 jonathan Exp $";
  19. #endif
  20.  
  21. /* Change log:
  22.  * $Log:    wprot.c,v $
  23.  * Revision 1.8  92/04/02  14:20:58  jonathan
  24.  * Backed out last change.
  25.  * 
  26.  * Revision 1.7  92/04/02  09:49:49  jonathan
  27.  * Don't free the doc->type in freeDocObj: it's not a copy!
  28.  * 
  29.  * Revision 1.6  92/02/12  13:57:34  jonathan
  30.  * Added "$Log" so RCS will put the log message in the header
  31.  * 
  32.  * 
  33. */
  34.  
  35. #define _C_WAIS_protocol_
  36.  
  37. /*    This file implements the Z39.50 extensions required for WAIS 
  38. */
  39.  
  40. #include "wprot.h"
  41. #include "cutil.h"
  42. #include "panic.h"
  43. #include <string.h> /* for memmove */
  44.  
  45. #ifndef ANSI_LIKE
  46. #include "ustubs.h"
  47. #endif
  48.  
  49. /* very rough estimates of the size of an object */
  50. #define DefWAISInitResponseSize        (size_t)200
  51. #define DefWAISSearchSize            (size_t)3000
  52. #define DefWAISSearchResponseSize    (size_t)6000
  53. #define DefWAISPresentSize            (size_t)1000
  54. #define DefWAISPresentResponseSize    (size_t)6000
  55. #define DefWAISDocHeaderSize        (size_t)500
  56. #define DefWAISShortHeaderSize        (size_t)200
  57. #define DefWAISLongHeaderSize        (size_t)800
  58. #define DefWAISDocTextSize            (size_t)6000
  59. #define DefWAISDocHeadlineSize        (size_t)500
  60. #define DefWAISDocCodeSize            (size_t)500
  61.  
  62. #define RESERVE_SPACE_FOR_WAIS_HEADER(len)    \
  63.      if (*len > 0)                            \
  64.          *len -= header_len;
  65.  
  66. static char* writeUserInfoHeader _AP((data_tag tag,long infoSize,    
  67.                       long estHeaderSize,char* buffer,
  68.                       long* len));
  69.  
  70. static unsigned long userInfoTagSize _AP((data_tag tag,
  71.                       unsigned long length));
  72.  
  73. /*----------------------------------------------------------------------*/
  74.  
  75. char*
  76. writeInitInfo(init,buffer,len)
  77. InitAPDU* init;
  78. char* buffer;
  79. long* len;
  80. {
  81.   char *userInfo, *buf;
  82.   /* The WAIS protocol doesn't use init info - does now! JG*/
  83.  
  84.   /* older servers barf on this.  Someday we can use it... 
  85.   userInfo = (char *)init->UserInformationField; */
  86.   userInfo = NULL;
  87.  
  88.   if(userInfo != NULL) {
  89.     buf = writeString(userInfo, DT_UserInformationField, buffer, len);
  90.     return(buf);
  91.   }
  92.   else return buffer;
  93. }
  94.  
  95. /*----------------------------------------------------------------------*/
  96.  
  97. static char* readUserInfoHeader _AP((data_tag* tag,unsigned long* num,
  98.                      char* buffer));
  99.  
  100. char*
  101. readInitInfo(info,buffer)
  102. void** info;
  103. char* buffer;
  104. {
  105.   /* The WAIS protocol doesn't use init info */
  106.   readString((char **)info, buffer);
  107.   return buffer;
  108. }
  109.  
  110. /*----------------------------------------------------------------------*/
  111.  
  112. static unsigned long
  113. userInfoTagSize(tag,length)
  114. data_tag tag;
  115. unsigned long length;
  116. /* return the number of bytes required to write the user info tag and
  117.    length 
  118.  */
  119. {
  120.   unsigned long size;
  121.  
  122.   /* calculate bytes required to represent tag.  max tag is 16K */
  123.   size = writtenCompressedIntSize(tag);
  124.   size += writtenCompressedIntSize(length);
  125.       
  126.   return(size);
  127. }   
  128.  
  129. /*----------------------------------------------------------------------*/
  130.  
  131. static char*
  132. writeUserInfoHeader(tag,infoSize,estHeaderSize,buffer,len)
  133. data_tag tag;
  134. long infoSize;
  135. long estHeaderSize;
  136. char* buffer;
  137. long* len;
  138. /* write the tag and size, making sure the info fits.  return the true end
  139.    of the info (after adjustment) note that the argument infoSize includes
  140.    estHeaderSize.  Note that the argument len is the number of bytes remaining
  141.    in the buffer.  Since we write the tag and size at the begining of the
  142.    buffer (in space that we reserved) we don't want to pass len the calls which
  143.    do that writing. 
  144.  */
  145. {
  146.   long dummyLen = 100;        /* plenty of space for a tag and size */
  147.   char* buf = buffer;
  148.   long realSize = infoSize - estHeaderSize;
  149.   long realHeaderSize = userInfoTagSize(tag,realSize);
  150.  
  151.   if (buffer == NULL || *len == 0)
  152.     return(NULL);
  153.   
  154.   /* write the tag */
  155.   buf = writeTag(tag,buf,&dummyLen);
  156.   
  157.   /* see if the if the header size was correct. if not,
  158.      we have to shift the info to fit the real header size */
  159.   if (estHeaderSize != realHeaderSize)
  160.     {                /* make sure there is enough space */
  161.       CHECK_FOR_SPACE_LEFT(realHeaderSize - estHeaderSize,len);
  162.       memmove(buffer + realHeaderSize,buffer + estHeaderSize,(size_t)(realSize));
  163.     }
  164.    
  165.   /* write the size */
  166.   writeCompressedInteger(realSize,buf,&dummyLen);
  167.   
  168.   /* return the true end of buffer */
  169.   return(buffer + realHeaderSize + realSize);
  170. }
  171.  
  172. /*----------------------------------------------------------------------*/
  173.  
  174. static char*
  175. readUserInfoHeader(tag,num,buffer)
  176. data_tag* tag;
  177. unsigned long* num;
  178. char* buffer;
  179. /* read the tag and size */
  180. {
  181.   char* buf = buffer;
  182.   buf = readTag(tag,buf);
  183.   buf = readCompressedInteger(num,buf);
  184.   return(buf); 
  185. }
  186.  
  187. /*----------------------------------------------------------------------*/
  188.  
  189. WAISInitResponse* 
  190. makeWAISInitResponse(chunkCode,
  191.              chunkIDLen,
  192.              chunkMarker,
  193.              highlightMarker,
  194.              deHighlightMarker,
  195.              newLineChars)
  196. long chunkCode;
  197. long chunkIDLen;
  198. char* chunkMarker;
  199. char* highlightMarker;
  200. char* deHighlightMarker;
  201. char* newLineChars;
  202. /* create a WAIS init response object */
  203. {
  204.   WAISInitResponse* init = (WAISInitResponse*)s_malloc((size_t)sizeof(WAISInitResponse));
  205.  
  206.   init->ChunkCode = chunkCode;    /* note: none are copied! */
  207.   init->ChunkIDLength = chunkIDLen;
  208.   init->ChunkMarker = chunkMarker;
  209.   init->HighlightMarker = highlightMarker;
  210.   init->DeHighlightMarker = deHighlightMarker;
  211.   init->NewlineCharacters = newLineChars;
  212.   
  213.   return(init);
  214. }
  215.  
  216. /*----------------------------------------------------------------------*/
  217.  
  218. void 
  219. freeWAISInitResponse(init)
  220. WAISInitResponse* init;
  221. /* free an object made with makeWAISInitResponse */
  222. {
  223.   s_free(init->ChunkMarker);
  224.   s_free(init->HighlightMarker);
  225.   s_free(init->DeHighlightMarker);
  226.   s_free(init->NewlineCharacters);
  227.   s_free(init);
  228. }
  229.  
  230. /*----------------------------------------------------------------------*/
  231.  
  232. char*
  233. writeInitResponseInfo(init,buffer,len)
  234. InitResponseAPDU* init;
  235. char* buffer;
  236. long* len;
  237. /* write an init response object */
  238. {
  239.   unsigned long header_len = userInfoTagSize(DT_UserInformationLength,
  240.                          DefWAISInitResponseSize);
  241.   char* buf = buffer + header_len;
  242.   WAISInitResponse* info = (WAISInitResponse*)init->UserInformationField;
  243.   unsigned long size;
  244.   
  245.   RESERVE_SPACE_FOR_WAIS_HEADER(len);
  246.     
  247.   buf = writeNum(info->ChunkCode,DT_ChunkCode,buf,len);
  248.   buf = writeNum(info->ChunkIDLength,DT_ChunkIDLength,buf,len);
  249.   buf = writeString(info->ChunkMarker,DT_ChunkMarker,buf,len);
  250.   buf = writeString(info->HighlightMarker,DT_HighlightMarker,buf,len);
  251.   buf = writeString(info->DeHighlightMarker,DT_DeHighlightMarker,buf,len);
  252.   buf = writeString(info->NewlineCharacters,DT_NewlineCharacters,buf,len);
  253.   
  254.   /* now write the header and size */
  255.   size = buf - buffer; 
  256.   buf = writeUserInfoHeader(DT_UserInformationLength,size,header_len,buffer,len);
  257.   
  258.   return(buf);
  259. }
  260.  
  261. /*----------------------------------------------------------------------*/
  262.  
  263. char*
  264. readInitResponseInfo(info,buffer)
  265. void** info;
  266. char* buffer;
  267. /* read an init response object */
  268. {
  269.   char* buf = buffer;
  270.   unsigned long size; 
  271.   unsigned long headerSize;
  272.   data_tag tag;
  273.   long chunkCode,chunkIDLen;
  274.   char* chunkMarker = NULL;
  275.   char* highlightMarker = NULL;
  276.   char* deHighlightMarker = NULL;
  277.   char* newLineChars = NULL;
  278.   
  279.   chunkCode = chunkIDLen = UNUSED;
  280.   
  281.   buf = readUserInfoHeader(&tag,&size,buf);
  282.   headerSize = buf - buffer;
  283.     
  284.   while (buf < (buffer + size + headerSize))
  285.     { data_tag tag = peekTag(buf);
  286.       switch (tag)
  287.     { case DT_ChunkCode:
  288.         buf = readNum(&chunkCode,buf);
  289.         break;
  290.       case DT_ChunkIDLength:
  291.         buf = readNum(&chunkIDLen,buf);
  292.         break;
  293.       case DT_ChunkMarker:
  294.         buf = readString(&chunkMarker,buf);
  295.         break;
  296.       case DT_HighlightMarker:
  297.         buf = readString(&highlightMarker,buf);
  298.         break;
  299.       case DT_DeHighlightMarker:
  300.         buf = readString(&deHighlightMarker,buf);
  301.         break;
  302.       case DT_NewlineCharacters:
  303.         buf = readString(&newLineChars,buf);
  304.         break;
  305.       default:
  306.         s_free(highlightMarker);
  307.         s_free(deHighlightMarker);
  308.         s_free(newLineChars);
  309.         REPORT_READ_ERROR(buf);
  310.         break;
  311.       }
  312.     }
  313.         
  314.   *info = (void *)makeWAISInitResponse(chunkCode,chunkIDLen,chunkMarker,
  315.                    highlightMarker,deHighlightMarker,
  316.                    newLineChars);
  317.   return(buf);
  318. }
  319.  
  320. /*----------------------------------------------------------------------*/
  321.  
  322. WAISSearch* 
  323. makeWAISSearch(seedWords,
  324.            docs,
  325.            textList,
  326.            dateFactor,
  327.            beginDateRange,
  328.            endDateRange,
  329.            maxDocsRetrieved)
  330. char* seedWords;
  331. DocObj** docs;
  332. char** textList;
  333. long dateFactor;
  334. char* beginDateRange;
  335. char* endDateRange;
  336. long maxDocsRetrieved;
  337.  
  338. /* create a type 3 query object */
  339. { 
  340.   WAISSearch* query = (WAISSearch*)s_malloc((size_t)sizeof(WAISSearch));
  341.  
  342.   query->SeedWords = seedWords;    /* not copied! */
  343.   query->Docs = docs;        /* not copied! */
  344.   query->TextList = textList;    /* not copied! */
  345.   query->DateFactor = dateFactor;
  346.   query->BeginDateRange = beginDateRange;
  347.   query->EndDateRange = endDateRange;
  348.   query->MaxDocumentsRetrieved = maxDocsRetrieved;
  349.   
  350.   return(query);
  351. }
  352.  
  353. /*----------------------------------------------------------------------*/
  354.  
  355. void 
  356. freeWAISSearch(query)
  357. WAISSearch* query;
  358.  
  359. /* destroy an object made with makeWAISSearch() */
  360. {
  361.   void* ptr = NULL;
  362.   long i;
  363.   
  364.   s_free(query->SeedWords);
  365.   
  366.   if (query->Docs != NULL)
  367.     for (i = 0,ptr = (void *)query->Docs[i]; ptr != NULL; ptr = (void *)query->Docs[++i])
  368.       freeDocObj((DocObj*)ptr);
  369.   s_free(query->Docs);
  370.    
  371.   if (query->TextList != NULL)    /* XXX revisit when textlist is fully defined */
  372.     for (i = 0,ptr = (void *)query->TextList[i]; ptr != NULL; ptr = (void *)query->TextList[++i])
  373.       s_free(ptr);
  374.   s_free(query->TextList);
  375.  
  376.   s_free(query->BeginDateRange);
  377.   s_free(query->EndDateRange);
  378.   s_free(query);
  379. }
  380.  
  381. /*----------------------------------------------------------------------*/
  382.  
  383. DocObj* 
  384. makeDocObjUsingWholeDocument(docID,type)
  385. any* docID;
  386. char* type;
  387.  
  388. /* construct a document object using byte chunks - only for use by
  389.    servers */
  390. {
  391.   DocObj* doc = (DocObj*)s_malloc((size_t)sizeof(DocObj));
  392.   doc->DocumentID = docID;        /* not copied! */
  393.   doc->Type = type;        /* not copied! */
  394.   doc->ChunkCode = CT_document;
  395.   return(doc);
  396. }
  397.  
  398. /*----------------------------------------------------------------------*/
  399.  
  400. DocObj* 
  401. makeDocObjUsingLines(docID,type,start,end)
  402. any* docID;
  403. char* type;
  404. long start;
  405. long end;
  406.  
  407. /* construct a document object using line chunks - only for use by
  408.    servers */
  409. {
  410.   DocObj* doc = (DocObj*)s_malloc((size_t)sizeof(DocObj));
  411.   doc->ChunkCode = CT_line;
  412.   doc->DocumentID = docID;        /* not copied */
  413.   doc->Type = type;        /* not copied! */
  414.   doc->ChunkStart.Pos = start;
  415.   doc->ChunkEnd.Pos = end;
  416.   return(doc);
  417. }
  418.  
  419. /*----------------------------------------------------------------------*/
  420.  
  421.  
  422. DocObj* 
  423. makeDocObjUsingBytes(docID,type,start,end)
  424. any* docID;
  425. char* type;
  426. long start;
  427. long end;
  428.  
  429. /* construct a document object using byte chunks - only for use by
  430.    servers */
  431. {
  432.   DocObj* doc = (DocObj*)s_malloc((size_t)sizeof(DocObj));
  433.   doc->ChunkCode = CT_byte;
  434.   doc->DocumentID = docID;        /* not copied */
  435.   doc->Type = type;        /* not copied! */
  436.   doc->ChunkStart.Pos = start;
  437.   doc->ChunkEnd.Pos = end;
  438.   return(doc);
  439. }
  440.  
  441. /*----------------------------------------------------------------------*/
  442.  
  443. DocObj* 
  444. makeDocObjUsingParagraphs(docID,type,start,end)
  445. any* docID;
  446. char* type;
  447. any* start;
  448. any* end;
  449.  
  450. /* construct a document object using byte chunks - only for use by
  451.    servers */
  452. {
  453.   DocObj* doc = (DocObj*)s_malloc((size_t)sizeof(DocObj));
  454.   doc->ChunkCode = CT_paragraph;
  455.   doc->DocumentID = docID;        /* not copied */
  456.   doc->Type = type;
  457.   doc->ChunkStart.ID = start; 
  458.   doc->ChunkEnd.ID = end; 
  459.   return(doc);
  460. }
  461.  
  462. /*----------------------------------------------------------------------*/
  463.  
  464. void
  465. freeDocObj(doc)
  466. DocObj* doc;
  467.  
  468. /* free a docObj */
  469. {
  470.   freeAny(doc->DocumentID);
  471.   s_free(doc->Type);
  472.   if (doc->ChunkCode == CT_paragraph)
  473.     { freeAny(doc->ChunkStart.ID);
  474.       freeAny(doc->ChunkEnd.ID);
  475.     }
  476.   s_free(doc);
  477. }
  478.  
  479. /*----------------------------------------------------------------------*/
  480.  
  481. static char* writeDocObj _AP((DocObj* doc,char* buffer,long* len));
  482.  
  483. static char*
  484. writeDocObj(doc,buffer,len)
  485. DocObj* doc;
  486. char* buffer;
  487. long* len;
  488.  
  489. /* write as little as we can about the doc obj */
  490. {
  491.   char* buf = buffer;
  492.   
  493.   /* we alwasy have to write the id, but its tag depends on if its a chunk */
  494.   if (doc->ChunkCode == CT_document)
  495.     buf = writeAny(doc->DocumentID,DT_DocumentID,buf,len);
  496.   else
  497.     buf = writeAny(doc->DocumentID,DT_DocumentIDChunk,buf,len);
  498.   
  499.   if (doc->Type != NULL)
  500.     buf = writeString(doc->Type,DT_TYPE,buf,len);
  501.   
  502.   switch (doc->ChunkCode)
  503.     { case CT_document:
  504.     /* do nothing - there is no chunk data */
  505.     break;
  506.       case CT_byte:
  507.       case CT_line:
  508.     buf = writeNum(doc->ChunkCode,DT_ChunkCode,buf,len);
  509.     buf = writeNum(doc->ChunkStart.Pos,DT_ChunkStartID,buf,len);
  510.     buf = writeNum(doc->ChunkEnd.Pos,DT_ChunkEndID,buf,len);
  511.     break;
  512.       case CT_paragraph:
  513.     buf = writeNum(doc->ChunkCode,DT_ChunkCode,buf,len);
  514.     buf = writeAny(doc->ChunkStart.ID,DT_ChunkStartID,buf,len);
  515.     buf = writeAny(doc->ChunkEnd.ID,DT_ChunkEndID,buf,len);
  516.     break;
  517.       default:
  518.     panic("Implementation error: unknown chuck type %ld",
  519.           doc->ChunkCode);
  520.     break;
  521.       }
  522.    
  523.   return(buf);
  524. }
  525.  
  526. /*----------------------------------------------------------------------*/
  527.  
  528. static char* readDocObj _AP((DocObj** doc,char* buffer));
  529.  
  530. static char*
  531. readDocObj(doc,buffer)
  532. DocObj** doc;
  533. char* buffer;
  534.  
  535. /* read whatever we have about the new document */
  536. {
  537.   char* buf = buffer;
  538.   data_tag tag;
  539.   
  540.   *doc = (DocObj*)s_malloc((size_t)sizeof(DocObj));
  541.   
  542.   tag = peekTag(buf);
  543.   buf = readAny(&((*doc)->DocumentID),buf);
  544.   
  545.   if (tag == DT_DocumentID)
  546.     { (*doc)->ChunkCode = CT_document;
  547.       tag = peekTag(buf);
  548.       if (tag == DT_TYPE)    /* XXX depends on DT_TYPE != what comes next */
  549.     buf = readString(&((*doc)->Type),buf);
  550.       /* ChunkStart and ChunkEnd are undefined */
  551.     }
  552.   else if (tag == DT_DocumentIDChunk)
  553.     { Boolean readParagraphs = false; /* for cleanup */
  554.       tag = peekTag(buf);
  555.       if (tag == DT_TYPE)    /* XXX depends on DT_TYPE != CT_FOO */
  556.     buf = readString(&((*doc)->Type),buf);
  557.       buf = readNum(&((*doc)->ChunkCode),buf);
  558.       switch ((*doc)->ChunkCode)
  559.     { case CT_byte:
  560.       case CT_line:
  561.         buf = readNum(&((*doc)->ChunkStart.Pos),buf);
  562.         buf = readNum(&((*doc)->ChunkEnd.Pos),buf);
  563.         break;
  564.       case CT_paragraph:
  565.         readParagraphs = true;
  566.         buf = readAny(&((*doc)->ChunkStart.ID),buf);
  567.         buf = readAny(&((*doc)->ChunkEnd.ID),buf);
  568.         break;
  569.       default:
  570.         freeAny((*doc)->DocumentID);
  571.         if (readParagraphs)
  572.           { freeAny((*doc)->ChunkStart.ID);
  573.         freeAny((*doc)->ChunkEnd.ID);
  574.           }
  575.         s_free(doc);
  576.         REPORT_READ_ERROR(buf);
  577.         break;
  578.       }
  579.     }
  580.   else
  581.     { freeAny((*doc)->DocumentID);
  582.       s_free(*doc);
  583.       REPORT_READ_ERROR(buf);
  584.     }
  585.   return(buf);  
  586. }
  587.  
  588. /*----------------------------------------------------------------------*/
  589.  
  590. char* 
  591. writeSearchInfo(query,buffer,len)
  592. SearchAPDU* query;
  593. char* buffer;
  594. long* len;
  595.  
  596. /* write out a WAIS query (type 1 or 3) */
  597. {
  598.   if (strcmp(query->QueryType,QT_TextRetrievalQuery) == 0)
  599.     { return(writeAny((any*)query->Query,DT_Query,buffer,len));
  600.     }
  601.   else
  602.     { unsigned long header_len = userInfoTagSize(DT_UserInformationLength,
  603.                          DefWAISSearchSize); 
  604.       char* buf = buffer + header_len;
  605.       WAISSearch* info = (WAISSearch*)query->Query;
  606.       unsigned long size;
  607.       long i;
  608.   
  609.       RESERVE_SPACE_FOR_WAIS_HEADER(len);
  610.        
  611.       buf = writeString(info->SeedWords,DT_SeedWords,buf,len);
  612.  
  613.       if (info->Docs != NULL)
  614.       { for (i = 0; info->Docs[i] != NULL; i++)
  615.       { buf = writeDocObj(info->Docs[i],buf,len);
  616.       }
  617.     }
  618.    
  619.       /* XXX text list */
  620.  
  621.       buf = writeNum(info->DateFactor,DT_DateFactor,buf,len);
  622.       buf = writeString(info->BeginDateRange,DT_BeginDateRange,buf,len);
  623.       buf = writeString(info->EndDateRange,DT_EndDateRange,buf,len);
  624.       buf = writeNum(info->MaxDocumentsRetrieved,DT_MaxDocumentsRetrieved,buf,len);
  625.   
  626.       /* now write the header and size */
  627.       size = buf - buffer; 
  628.       buf = writeUserInfoHeader(DT_UserInformationLength,size,header_len,buffer,len);
  629.    
  630.       return(buf);
  631.     }
  632. }
  633.  
  634. /*----------------------------------------------------------------------*/
  635.  
  636. char* 
  637. readSearchInfo(info,buffer)
  638. void** info;
  639. char* buffer;
  640.  
  641. /* read a WAIS query (type 1 or 3) */
  642. {
  643.   data_tag type = peekTag(buffer);
  644.   if (type == DT_Query)        /* this is a type 1 query */
  645.     { char* buf = buffer;
  646.       any* query = NULL;
  647.       buf = readAny(&query,buf);
  648.       *info = (void *)query;
  649.       return(buf);
  650.     }
  651.   else                /* a type 3 query */
  652.     { char* buf = buffer;
  653.       unsigned long size; 
  654.       unsigned long headerSize;
  655.       data_tag tag;
  656.       char* seedWords = NULL;
  657.       char* beginDateRange = NULL;
  658.       char* endDateRange = NULL;
  659.       long dateFactor,maxDocsRetrieved;
  660.       char** textList = NULL; 
  661.       DocObj** docIDs = NULL;
  662.       DocObj* doc = NULL;
  663.       long docs = 0;
  664.       long i;
  665.       void* ptr = NULL;
  666.  
  667.       dateFactor = maxDocsRetrieved = UNUSED;
  668.   
  669.       buf = readUserInfoHeader(&tag,&size,buf);
  670.       headerSize = buf - buffer;
  671.   
  672.       while (buf < (buffer + size + headerSize))
  673.     { data_tag tag = peekTag(buf);
  674.       switch (tag)
  675.         { case DT_SeedWords:
  676.         buf = readString(&seedWords,buf);
  677.         break;
  678.           case DT_DocumentID:
  679.           case DT_DocumentIDChunk:
  680.         if (docIDs == NULL) /* create a new doc list */
  681.           { docIDs = (DocObj**)s_malloc((size_t)sizeof(DocObj*) * 2);
  682.           }
  683.         else        /* grow the doc list */
  684.           { docIDs = (DocObj**)s_realloc((char*)docIDs,(size_t)(sizeof(DocObj*) * (docs + 2)));
  685.           }
  686.         buf = readDocObj(&doc,buf);
  687.         if (buf == NULL) 
  688.           { s_free(seedWords);
  689.             s_free(beginDateRange);
  690.             s_free(endDateRange);
  691.             if (docIDs != NULL)
  692.               for (i = 0,ptr = (void *)docIDs[i]; ptr != NULL; ptr = (void *)docIDs[++i])
  693.             freeDocObj((DocObj*)ptr);
  694.             s_free(docIDs);
  695.             /* XXX should also free textlist when it is fully defined */
  696.           }
  697.         RETURN_ON_NULL(buf);
  698.         docIDs[docs++] = doc; /* put it in the list */
  699.         docIDs[docs] = NULL;
  700.         break;
  701.           case DT_TextList:
  702.         /* XXX */
  703.         break;
  704.           case DT_DateFactor:
  705.         buf = readNum(&dateFactor,buf);
  706.         break;
  707.           case DT_BeginDateRange:
  708.         buf = readString(&beginDateRange,buf);
  709.         break;
  710.           case DT_EndDateRange:
  711.         buf = readString(&endDateRange,buf);
  712.         break;
  713.           case DT_MaxDocumentsRetrieved:
  714.         buf = readNum(&maxDocsRetrieved,buf);
  715.         break;
  716.           default:
  717.         s_free(seedWords);
  718.         s_free(beginDateRange);
  719.         s_free(endDateRange);
  720.         if (docIDs != NULL)
  721.           for (i = 0,ptr = (void *)docIDs[i]; ptr != NULL; ptr = (void *)docIDs[++i])
  722.             freeDocObj((DocObj*)ptr);
  723.         s_free(docIDs);
  724.         /* XXX should also free textlist when it is fully defined */
  725.         REPORT_READ_ERROR(buf);
  726.         break;
  727.           }
  728.     }
  729.         
  730.       *info = (void *)makeWAISSearch(seedWords,docIDs,textList,
  731.                      dateFactor,beginDateRange,endDateRange,
  732.                      maxDocsRetrieved);
  733.       return(buf);
  734.     }
  735. }
  736.  
  737. /*----------------------------------------------------------------------*/
  738.  
  739. WAISDocumentHeader*
  740. makeWAISDocumentHeader(docID,
  741.                versionNumber,
  742.                score,
  743.                bestMatch,
  744.                docLen,
  745.                lines,
  746.                types,
  747.                source,
  748.                date,
  749.                headline,
  750.                originCity)
  751. any* docID;
  752. long versionNumber;
  753. long score;
  754. long bestMatch;
  755. long docLen;
  756. long lines;
  757. char** types;
  758. char* source;
  759. char* date;
  760. char* headline;
  761. char* originCity;
  762.  
  763. /* construct a standard document header, note that no fields are copied!
  764.    if the application needs to save these fields, it should copy them,
  765.    or set the field in this object to NULL before freeing it.
  766.  */
  767. {
  768.   WAISDocumentHeader* header = 
  769.     (WAISDocumentHeader*)s_malloc((size_t)sizeof(WAISDocumentHeader));
  770.  
  771.   header->DocumentID = docID;
  772.   header->VersionNumber = versionNumber;
  773.   header->Score = score;
  774.   header->BestMatch = bestMatch;
  775.   header->DocumentLength = docLen;
  776.   header->Lines = lines;
  777.   header->Types = types;
  778.   header->Source = source;
  779.   header->Date = date;
  780.   header->Headline = headline;
  781.   header->OriginCity = originCity;
  782.   
  783.   return(header);
  784. }
  785.  
  786. /*----------------------------------------------------------------------*/
  787.  
  788. void
  789. freeWAISDocumentHeader(header)
  790. WAISDocumentHeader* header;
  791.  
  792. {
  793.   freeAny(header->DocumentID);
  794.   doList((void**)header->Types,fs_free); /* can't use the macro here ! */
  795.   s_free(header->Types);
  796.   s_free(header->Source);
  797.   s_free(header->Date);
  798.   s_free(header->Headline);
  799.   s_free(header->OriginCity);
  800.   s_free(header);
  801. }
  802.  
  803. /*----------------------------------------------------------------------*/
  804.  
  805. char*
  806. writeWAISDocumentHeader(header,buffer,len)
  807. WAISDocumentHeader* header;
  808. char* buffer;
  809. long* len;
  810. {
  811.   unsigned long header_len = userInfoTagSize(DT_DocumentHeaderGroup ,
  812.                          DefWAISDocHeaderSize);
  813.   char* buf = buffer + header_len;
  814.   unsigned long size;
  815.   
  816.   RESERVE_SPACE_FOR_WAIS_HEADER(len);
  817.    
  818.   buf = writeAny(header->DocumentID,DT_DocumentID,buf,len);
  819.   buf = writeNum(header->VersionNumber,DT_VersionNumber,buf,len);
  820.   buf = writeNum(header->Score,DT_Score,buf,len);
  821.   buf = writeNum(header->BestMatch,DT_BestMatch,buf,len);
  822.   buf = writeNum(header->DocumentLength,DT_DocumentLength,buf,len);
  823.   buf = writeNum(header->Lines,DT_Lines,buf,len);
  824.   if (header->Types != NULL)
  825.     { long size;
  826.       char* ptr = NULL;
  827.       long i;
  828.       buf = writeTag(DT_TYPE_BLOCK,buf,len);
  829.       for (i = 0,size = 0,ptr = header->Types[i]; ptr != NULL; ptr = header->Types[++i])
  830.     { long typeSize = strlen(ptr);
  831.       size += writtenTagSize(DT_TYPE);
  832.       size += writtenCompressedIntSize(typeSize);
  833.       size += typeSize; 
  834.     }
  835.       buf = writeCompressedInteger((unsigned long)size,buf,len);
  836.       for (i = 0,ptr = header->Types[i]; ptr != NULL; ptr = header->Types[++i])
  837.     buf = writeString(ptr,DT_TYPE,buf,len);
  838.     }
  839.   buf = writeString(header->Source,DT_Source,buf,len);
  840.   buf = writeString(header->Date,DT_Date,buf,len);
  841.   buf = writeString(header->Headline,DT_Headline,buf,len);
  842.   buf = writeString(header->OriginCity,DT_OriginCity,buf,len);
  843.   
  844.   /* now write the header and size */
  845.   size = buf - buffer; 
  846.   buf = writeUserInfoHeader(DT_DocumentHeaderGroup,size,header_len,buffer,len);
  847.  
  848.   return(buf);
  849. }
  850.  
  851. /*----------------------------------------------------------------------*/
  852.  
  853. char*
  854. readWAISDocumentHeader(header,buffer)
  855. WAISDocumentHeader** header;
  856. char* buffer;
  857. {
  858.   char* buf = buffer;
  859.   unsigned long size; 
  860.   unsigned long headerSize;
  861.   data_tag tag;
  862.   any* docID = NULL;
  863.   long versionNumber,score,bestMatch,docLength,lines;
  864.   char** types = NULL;
  865.   char *source = NULL;
  866.   char *date = NULL;
  867.   char *headline = NULL;
  868.   char *originCity = NULL;
  869.   
  870.   versionNumber = score = bestMatch = docLength = lines = UNUSED;
  871.   
  872.   buf = readUserInfoHeader(&tag,&size,buf);
  873.   headerSize = buf - buffer;
  874.     
  875.   while (buf < (buffer + size + headerSize))
  876.     { data_tag tag = peekTag(buf);
  877.       switch (tag)
  878.     { case DT_DocumentID:
  879.         buf = readAny(&docID,buf);
  880.         break;
  881.       case DT_VersionNumber:
  882.         buf = readNum(&versionNumber,buf);
  883.         break;
  884.       case DT_Score:
  885.         buf = readNum(&score,buf);
  886.         break;
  887.       case DT_BestMatch:
  888.         buf = readNum(&bestMatch,buf);
  889.         break;
  890.       case DT_DocumentLength:
  891.         buf = readNum(&docLength,buf);
  892.         break;
  893.       case DT_Lines:
  894.         buf = readNum(&lines,buf);
  895.         break;
  896.       case DT_TYPE_BLOCK:
  897.         { unsigned long size = -1;
  898.           long numTypes = 0;
  899.           buf = readTag(&tag,buf);
  900.           buf = readCompressedInteger(&size,buf);
  901.           while (size > 0)
  902.         { char* type = NULL;
  903.           char* originalBuf = buf;
  904.           buf = readString(&type,buf);
  905.           types = (char**)s_realloc(types,(size_t)(sizeof(char*) * (numTypes + 2)));
  906.           types[numTypes++] = type;
  907.           types[numTypes] = NULL;
  908.           size -= (buf - originalBuf);
  909.         }
  910.         }
  911.       case DT_Source:
  912.         buf = readString(&source,buf);
  913.         break;
  914.       case DT_Date:
  915.         buf = readString(&date,buf);
  916.         break;
  917.       case DT_Headline:
  918.         buf = readString(&headline,buf);
  919.         break;
  920.       case DT_OriginCity:
  921.         buf = readString(&originCity,buf);
  922.         break;
  923.       default:
  924.         freeAny(docID);
  925.         s_free(source);
  926.         s_free(date);
  927.         s_free(headline);
  928.         s_free(originCity);
  929.         REPORT_READ_ERROR(buf);
  930.         break;
  931.       }
  932.     }
  933.         
  934.   *header = makeWAISDocumentHeader(docID,versionNumber,score,bestMatch,
  935.                    docLength,lines,types,source,date,headline,
  936.                    originCity);
  937.   return(buf);
  938. }
  939.  
  940. /*----------------------------------------------------------------------*/
  941.  
  942. WAISDocumentShortHeader*
  943. makeWAISDocumentShortHeader(docID,
  944.                 versionNumber,
  945.                 score,
  946.                 bestMatch,
  947.                 docLen,
  948.                 lines)
  949. any* docID;
  950. long versionNumber;
  951. long score;
  952. long bestMatch;
  953. long docLen;
  954. long lines;
  955. /* construct a short document header, note that no fields are copied!
  956.    if the application needs to save these fields, it should copy them,
  957.    or set the field in this object to NULL before freeing it.
  958.  */
  959. {
  960.   WAISDocumentShortHeader* header = 
  961.     (WAISDocumentShortHeader*)s_malloc((size_t)sizeof(WAISDocumentShortHeader));
  962.  
  963.   header->DocumentID = docID;
  964.   header->VersionNumber = versionNumber;
  965.   header->Score = score;
  966.   header->BestMatch = bestMatch;
  967.   header->DocumentLength = docLen;
  968.   header->Lines = lines;
  969.   
  970.   return(header);
  971. }
  972.  
  973. /*----------------------------------------------------------------------*/
  974.  
  975. void
  976. freeWAISDocumentShortHeader(header)
  977. WAISDocumentShortHeader* header;
  978. {
  979.   freeAny(header->DocumentID);
  980.   s_free(header);
  981. }
  982.  
  983. /*----------------------------------------------------------------------*/
  984.  
  985. char*
  986. writeWAISDocumentShortHeader(header,buffer,len)
  987. WAISDocumentShortHeader* header;
  988. char* buffer;
  989. long* len;
  990. {
  991.   unsigned long header_len = userInfoTagSize(DT_DocumentShortHeaderGroup ,
  992.                          DefWAISShortHeaderSize);
  993.   char* buf = buffer + header_len;
  994.   unsigned long size;
  995.   
  996.   RESERVE_SPACE_FOR_WAIS_HEADER(len);
  997.    
  998.   buf = writeAny(header->DocumentID,DT_DocumentID,buf,len);
  999.   buf = writeNum(header->VersionNumber,DT_VersionNumber,buf,len);
  1000.   buf = writeNum(header->Score,DT_Score,buf,len);
  1001.   buf = writeNum(header->BestMatch,DT_BestMatch,buf,len);
  1002.   buf = writeNum(header->DocumentLength,DT_DocumentLength,buf,len);
  1003.   buf = writeNum(header->Lines,DT_Lines,buf,len);
  1004.   
  1005.   /* now write the header and size */
  1006.   size = buf - buffer; 
  1007.   buf = writeUserInfoHeader(DT_DocumentShortHeaderGroup,size,header_len,buffer,len);
  1008.  
  1009.   return(buf);
  1010. }
  1011.  
  1012. /*----------------------------------------------------------------------*/
  1013.  
  1014. char*
  1015. readWAISDocumentShortHeader(header,buffer)
  1016. WAISDocumentShortHeader** header;
  1017. char* buffer;
  1018. {
  1019.   char* buf = buffer;
  1020.   unsigned long size; 
  1021.   unsigned long headerSize;
  1022.   data_tag tag;
  1023.   any* docID = NULL;
  1024.   long versionNumber,score,bestMatch,docLength,lines;
  1025.   
  1026.   versionNumber = score = bestMatch = docLength = lines = UNUSED;
  1027.   
  1028.   buf = readUserInfoHeader(&tag,&size,buf);
  1029.   headerSize = buf - buffer;
  1030.     
  1031.   while (buf < (buffer + size + headerSize))
  1032.     { data_tag tag = peekTag(buf);
  1033.       switch (tag)
  1034.     { case DT_DocumentID:
  1035.         buf = readAny(&docID,buf);
  1036.         break;
  1037.       case DT_VersionNumber:
  1038.         buf = readNum(&versionNumber,buf);
  1039.         break;
  1040.       case DT_Score:
  1041.         buf = readNum(&score,buf);
  1042.         break;
  1043.       case DT_BestMatch:
  1044.         buf = readNum(&bestMatch,buf);
  1045.         break;
  1046.       case DT_DocumentLength:
  1047.         buf = readNum(&docLength,buf);
  1048.         break;
  1049.       case DT_Lines:
  1050.         buf = readNum(&lines,buf);
  1051.         break;
  1052.       default:
  1053.         freeAny(docID);
  1054.         REPORT_READ_ERROR(buf);
  1055.         break;
  1056.       }
  1057.     }
  1058.         
  1059.   *header = makeWAISDocumentShortHeader(docID,versionNumber,score,bestMatch,
  1060.                     docLength,lines);
  1061.   return(buf);
  1062. }
  1063.  
  1064. /*----------------------------------------------------------------------*/
  1065.  
  1066. WAISDocumentLongHeader*
  1067. makeWAISDocumentLongHeader(docID,
  1068.                versionNumber,
  1069.                score,
  1070.                bestMatch,
  1071.                docLen,
  1072.                lines,
  1073.                types,
  1074.                source,
  1075.                date,
  1076.                headline,
  1077.                originCity,
  1078.                stockCodes,
  1079.                companyCodes,
  1080.                industryCodes)
  1081. any* docID;
  1082. long versionNumber;
  1083. long score;
  1084. long bestMatch;
  1085. long docLen;
  1086. long lines;
  1087. char** types;
  1088. char* source;
  1089. char* date;
  1090. char* headline;
  1091. char* originCity;
  1092. char* stockCodes;
  1093. char* companyCodes;
  1094. char* industryCodes;
  1095. /* construct a long document header, note that no fields are copied!
  1096.    if the application needs to save these fields, it should copy them,
  1097.    or set the field in this object to NULL before freeing it.
  1098.  */
  1099. {
  1100.   WAISDocumentLongHeader* header = 
  1101.     (WAISDocumentLongHeader*)s_malloc((size_t)sizeof(WAISDocumentLongHeader));
  1102.  
  1103.   header->DocumentID = docID;
  1104.   header->VersionNumber = versionNumber;
  1105.   header->Score = score;
  1106.   header->BestMatch = bestMatch;
  1107.   header->DocumentLength = docLen;
  1108.   header->Lines = lines;
  1109.   header->Types = types;
  1110.   header->Source = source;
  1111.   header->Date = date;
  1112.   header->Headline = headline;
  1113.   header->OriginCity = originCity;
  1114.   header->StockCodes = stockCodes;
  1115.   header->CompanyCodes = companyCodes;
  1116.   header->IndustryCodes = industryCodes;
  1117.   
  1118.   return(header);
  1119. }
  1120.  
  1121. /*----------------------------------------------------------------------*/
  1122.  
  1123. void
  1124. freeWAISDocumentLongHeader(header)
  1125. WAISDocumentLongHeader* header;
  1126. {
  1127.   freeAny(header->DocumentID);
  1128.   doList((void**)header->Types,fs_free); /* can't use the macro here! */
  1129.   s_free(header->Source);
  1130.   s_free(header->Date);
  1131.   s_free(header->Headline);
  1132.   s_free(header->OriginCity);
  1133.   s_free(header->StockCodes);
  1134.   s_free(header->CompanyCodes);
  1135.   s_free(header->IndustryCodes);
  1136.   s_free(header);
  1137. }
  1138.  
  1139. /*----------------------------------------------------------------------*/
  1140.  
  1141. char*
  1142. writeWAISDocumentLongHeader(header,buffer,len)
  1143. WAISDocumentLongHeader* header;
  1144. char* buffer;
  1145. long* len;
  1146. {
  1147.   unsigned long header_len = userInfoTagSize(DT_DocumentLongHeaderGroup ,
  1148.                          DefWAISLongHeaderSize);
  1149.   char* buf = buffer + header_len;
  1150.   unsigned long size;
  1151.   
  1152.   RESERVE_SPACE_FOR_WAIS_HEADER(len);
  1153.    
  1154.   buf = writeAny(header->DocumentID,DT_DocumentID,buf,len);
  1155.   buf = writeNum(header->VersionNumber,DT_VersionNumber,buf,len);
  1156.   buf = writeNum(header->Score,DT_Score,buf,len);
  1157.   buf = writeNum(header->BestMatch,DT_BestMatch,buf,len);
  1158.   buf = writeNum(header->DocumentLength,DT_DocumentLength,buf,len);
  1159.   buf = writeNum(header->Lines,DT_Lines,buf,len);
  1160.   if (header->Types != NULL)
  1161.     { long size;
  1162.       char* ptr = NULL;
  1163.       long i;
  1164.       buf = writeTag(DT_TYPE_BLOCK,buf,len);
  1165.       for (i = 0,size = 0,ptr = header->Types[i]; ptr != NULL; ptr = header->Types[++i])
  1166.     { long typeSize = strlen(ptr);
  1167.       size += writtenTagSize(DT_TYPE);
  1168.       size += writtenCompressedIntSize(typeSize);
  1169.       size += typeSize; 
  1170.     }
  1171.       buf = writeCompressedInteger((unsigned long)size,buf,len);
  1172.       for (i = 0,ptr = header->Types[i]; ptr != NULL; ptr = header->Types[++i])
  1173.     buf = writeString(ptr,DT_TYPE,buf,len);
  1174.     }
  1175.   buf = writeString(header->Source,DT_Source,buf,len);
  1176.   buf = writeString(header->Date,DT_Date,buf,len);
  1177.   buf = writeString(header->Headline,DT_Headline,buf,len);
  1178.   buf = writeString(header->OriginCity,DT_OriginCity,buf,len);
  1179.   buf = writeString(header->StockCodes,DT_StockCodes,buf,len);
  1180.   buf = writeString(header->CompanyCodes,DT_CompanyCodes,buf,len);
  1181.   buf = writeString(header->IndustryCodes,DT_IndustryCodes,buf,len);
  1182.   
  1183.   /* now write the header and size */
  1184.   size = buf - buffer; 
  1185.   buf = writeUserInfoHeader(DT_DocumentLongHeaderGroup,size,header_len,buffer,len);
  1186.  
  1187.   return(buf);
  1188. }
  1189.  
  1190. /*----------------------------------------------------------------------*/
  1191.  
  1192. char*
  1193. readWAISDocumentLongHeader(header,buffer)
  1194. WAISDocumentLongHeader** header;
  1195. char* buffer;
  1196. {
  1197.   char* buf = buffer;
  1198.   unsigned long size; 
  1199.   unsigned long headerSize;
  1200.   data_tag tag;
  1201.   any* docID;
  1202.   long versionNumber,score,bestMatch,docLength,lines;
  1203.   char **types;
  1204.   char *source,*date,*headline,*originCity,*stockCodes,*companyCodes,*industryCodes;
  1205.   
  1206.   docID = NULL;
  1207.   versionNumber = score = bestMatch = docLength = lines = UNUSED;
  1208.   types = NULL;
  1209.   source = date = headline = originCity = stockCodes = companyCodes = industryCodes = NULL;
  1210.   
  1211.   buf = readUserInfoHeader(&tag,&size,buf);
  1212.   headerSize = buf - buffer;
  1213.     
  1214.   while (buf < (buffer + size + headerSize))
  1215.     { data_tag tag = peekTag(buf);
  1216.       switch (tag)
  1217.     { case DT_DocumentID:
  1218.         buf = readAny(&docID,buf);
  1219.         break;
  1220.       case DT_VersionNumber:
  1221.         buf = readNum(&versionNumber,buf);
  1222.         break;
  1223.       case DT_Score:
  1224.         buf = readNum(&score,buf);
  1225.         break;
  1226.       case DT_BestMatch:
  1227.         buf = readNum(&bestMatch,buf);
  1228.         break;
  1229.       case DT_DocumentLength:
  1230.         buf = readNum(&docLength,buf);
  1231.         break;
  1232.       case DT_Lines:
  1233.         buf = readNum(&lines,buf);
  1234.         break;
  1235.       case DT_TYPE_BLOCK:
  1236.         { unsigned long size = -1;
  1237.           long numTypes = 0;
  1238.           buf = readTag(&tag,buf);
  1239.           readCompressedInteger(&size,buf);
  1240.           while (size > 0)
  1241.         { char* type = NULL;
  1242.           char* originalBuf = buf;
  1243.           buf = readString(&type,buf);
  1244.           types = (char**)s_realloc(types,(size_t)(sizeof(char*) * (numTypes + 2)));
  1245.           types[numTypes++] = type;
  1246.           types[numTypes] = NULL;
  1247.           size -= (buf - originalBuf);
  1248.         }
  1249.         }
  1250.       case DT_Source:
  1251.         buf = readString(&source,buf);
  1252.         break;
  1253.       case DT_Date:
  1254.         buf = readString(&date,buf);
  1255.         break;
  1256.       case DT_Headline:
  1257.         buf = readString(&headline,buf);
  1258.         break;
  1259.       case DT_OriginCity:
  1260.         buf = readString(&originCity,buf);
  1261.         break;
  1262.       case DT_StockCodes:
  1263.         buf = readString(&stockCodes,buf);
  1264.         break;
  1265.       case DT_CompanyCodes:
  1266.         buf = readString(&companyCodes,buf);
  1267.         break;
  1268.       case DT_IndustryCodes:
  1269.         buf = readString(&industryCodes,buf);
  1270.         break;
  1271.       default:
  1272.         freeAny(docID);
  1273.         s_free(source);
  1274.         s_free(date);
  1275.         s_free(headline);
  1276.         s_free(originCity);
  1277.         s_free(stockCodes);
  1278.         s_free(companyCodes);
  1279.         s_free(industryCodes);
  1280.         REPORT_READ_ERROR(buf);
  1281.         break;
  1282.       }
  1283.     }
  1284.         
  1285.   *header = makeWAISDocumentLongHeader(docID,versionNumber,score,bestMatch,
  1286.                        docLength,lines,types,source,date,headline,
  1287.                        originCity,stockCodes,companyCodes,
  1288.                        industryCodes);
  1289.   return(buf);
  1290. }
  1291.  
  1292. /*----------------------------------------------------------------------*/
  1293.  
  1294. WAISSearchResponse*
  1295. makeWAISSearchResponse(seedWordsUsed,
  1296.                docHeaders,
  1297.                shortHeaders,
  1298.                longHeaders,
  1299.                text,
  1300.                headlines,
  1301.                codes,
  1302.                diagnostics)
  1303. char* seedWordsUsed;
  1304. WAISDocumentHeader** docHeaders;
  1305. WAISDocumentShortHeader** shortHeaders;
  1306. WAISDocumentLongHeader** longHeaders;
  1307. WAISDocumentText** text;
  1308. WAISDocumentHeadlines** headlines;
  1309. WAISDocumentCodes** codes;
  1310. diagnosticRecord** diagnostics;
  1311. {
  1312.   WAISSearchResponse* response = (WAISSearchResponse*)s_malloc((size_t)sizeof(WAISSearchResponse));
  1313.   
  1314.   response->SeedWordsUsed = seedWordsUsed;
  1315.   response->DocHeaders = docHeaders;
  1316.   response->ShortHeaders = shortHeaders;
  1317.   response->LongHeaders = longHeaders;
  1318.   response->Text = text;
  1319.   response->Headlines = headlines;
  1320.   response->Codes = codes;
  1321.   response->Diagnostics = diagnostics;
  1322.   
  1323.   return(response);
  1324. }
  1325.  
  1326. /*----------------------------------------------------------------------*/
  1327.  
  1328. void
  1329. freeWAISSearchResponse(response)
  1330. WAISSearchResponse* response;
  1331. {
  1332.   void* ptr = NULL;
  1333.   long i;
  1334.  
  1335.   s_free(response->SeedWordsUsed);
  1336.  
  1337.   if (response->DocHeaders != NULL)
  1338.     for (i = 0,ptr = (void *)response->DocHeaders[i]; ptr != NULL; ptr = (void *)response->DocHeaders[++i])
  1339.       freeWAISDocumentHeader((WAISDocumentHeader*)ptr);
  1340.   s_free(response->DocHeaders);
  1341.    
  1342.   if (response->ShortHeaders != NULL)
  1343.     for (i = 0,ptr = (void *)response->ShortHeaders[i]; ptr != NULL; ptr = (void *)response->ShortHeaders[++i])
  1344.       freeWAISDocumentShortHeader((WAISDocumentShortHeader*)ptr);
  1345.   s_free(response->ShortHeaders);
  1346.    
  1347.   if (response->LongHeaders != NULL)
  1348.     for (i = 0,ptr = (void *)response->LongHeaders[i]; ptr != NULL; ptr = (void *)response->LongHeaders[++i])
  1349.       freeWAISDocumentLongHeader((WAISDocumentLongHeader*)ptr);
  1350.   s_free(response->LongHeaders);
  1351.    
  1352.   if (response->Text != NULL)
  1353.     for (i = 0,ptr = (void *)response->Text[i]; ptr != NULL; ptr = (void *)response->Text[++i])
  1354.       freeWAISDocumentText((WAISDocumentText*)ptr);
  1355.   s_free(response->Text);
  1356.    
  1357.   if (response->Headlines != NULL)
  1358.     for (i = 0,ptr = (void *)response->Headlines[i]; ptr != NULL; ptr = (void *)response->Headlines[++i])
  1359.       freeWAISDocumentHeadlines((WAISDocumentHeadlines*)ptr);
  1360.   s_free(response->Headlines);
  1361.    
  1362.   if (response->Codes != NULL)
  1363.     for (i = 0,ptr = (void *)response->Codes[i]; ptr != NULL; ptr = (void *)response->Codes[++i])
  1364.       freeWAISDocumentCodes((WAISDocumentCodes*)ptr);
  1365.   s_free(response->Codes);
  1366.    
  1367.   if (response->Diagnostics != NULL)
  1368.     for (i = 0,ptr = (void *)response->Diagnostics[i]; ptr != NULL; ptr = (void *)response->Diagnostics[++i])
  1369.       freeDiag((diagnosticRecord*)ptr);
  1370.   s_free(response->Diagnostics);
  1371.   
  1372.   s_free(response);
  1373. }
  1374.  
  1375. /*----------------------------------------------------------------------*/
  1376.  
  1377. char* 
  1378. writeSearchResponseInfo(query,buffer,len)
  1379. SearchResponseAPDU* query;
  1380. char* buffer;
  1381. long* len;
  1382. {
  1383.   unsigned long header_len = userInfoTagSize(DT_UserInformationLength,
  1384.                          DefWAISSearchResponseSize);
  1385.   char* buf = buffer + header_len;
  1386.   WAISSearchResponse* info = (WAISSearchResponse*)query->DatabaseDiagnosticRecords;
  1387.   unsigned long size;
  1388.   void* header = NULL;
  1389.   long i;
  1390.   
  1391.   RESERVE_SPACE_FOR_WAIS_HEADER(len);
  1392.   
  1393.   buf = writeString(info->SeedWordsUsed,DT_SeedWordsUsed,buf,len);
  1394.   
  1395.   /* write out all the headers */
  1396.   if (info->DocHeaders != NULL)
  1397.     { for (i = 0,header = (void *)info->DocHeaders[i]; header != NULL; header = (void *)info->DocHeaders[++i])
  1398.     buf = writeWAISDocumentHeader((WAISDocumentHeader*)header,buf,len);
  1399.       }
  1400.    
  1401.   if (info->ShortHeaders != NULL)
  1402.     { for (i = 0,header = (void *)info->ShortHeaders[i]; header != NULL; header = (void *)info->ShortHeaders[++i])
  1403.     buf = writeWAISDocumentShortHeader((WAISDocumentShortHeader*)header,buf,len);
  1404.       }
  1405.  
  1406.   if (info->LongHeaders != NULL)
  1407.     { for (i = 0,header = (void *)info->LongHeaders[i]; header != NULL; header = (void *)info->LongHeaders[++i])
  1408.     buf = writeWAISDocumentLongHeader((WAISDocumentLongHeader*)header,buf,len);
  1409.       }
  1410.  
  1411.   if (info->Text != NULL)
  1412.     { for (i = 0,header = (void *)info->Text[i]; header != NULL; header = (void *)info->Text[++i])
  1413.     buf = writeWAISDocumentText((WAISDocumentText*)header,buf,len);
  1414.       }
  1415.  
  1416.   if (info->Headlines != NULL)
  1417.     { for (i = 0,header = (void *)info->Headlines[i]; header != NULL; header = (void *)info->Headlines[++i])
  1418.     buf = writeWAISDocumentHeadlines((WAISDocumentHeadlines*)header,buf,len);
  1419.       }
  1420.  
  1421.   if (info->Codes != NULL)
  1422.     { for (i = 0,header = (void *)info->Codes[i]; header != NULL;header = (void *)info->Codes[++i])
  1423.     buf = writeWAISDocumentCodes((WAISDocumentCodes*)header,buf,len);
  1424.       }
  1425.  
  1426.   if (info->Diagnostics != NULL)
  1427.     { for (i = 0, header = (void *)info->Diagnostics[i]; header != NULL; header = (void *)info->Diagnostics[++i])
  1428.     buf = writeDiag((diagnosticRecord*)header,buf,len);
  1429.       }
  1430.    
  1431.   /* now write the header and size */
  1432.   size = buf - buffer; 
  1433.   buf = writeUserInfoHeader(DT_UserInformationLength,size,header_len,buffer,len);
  1434.   
  1435.   return(buf);
  1436. }
  1437.  
  1438. /*----------------------------------------------------------------------*/
  1439.  
  1440. static void
  1441. cleanUpWaisSearchResponse _AP((char* buf,char* seedWordsUsed,
  1442.                    WAISDocumentHeader** docHeaders,
  1443.                    WAISDocumentShortHeader** shortHeaders,
  1444.                    WAISDocumentLongHeader** longHeaders,
  1445.                    WAISDocumentText** text,
  1446.                    WAISDocumentHeadlines** headlines,
  1447.                    WAISDocumentCodes** codes,
  1448.                    diagnosticRecord**diags));
  1449.  
  1450. static void
  1451. cleanUpWaisSearchResponse (buf,seedWordsUsed,docHeaders,shortHeaders,
  1452.                longHeaders,text,headlines,codes,diags)
  1453. char* buf;
  1454. char* seedWordsUsed;
  1455. WAISDocumentHeader** docHeaders;
  1456. WAISDocumentShortHeader** shortHeaders;
  1457. WAISDocumentLongHeader** longHeaders;
  1458. WAISDocumentText** text;
  1459. WAISDocumentHeadlines** headlines;
  1460. WAISDocumentCodes** codes;
  1461. diagnosticRecord** diags;
  1462. /* if buf is NULL, we have just gotten a read error, and need to clean up 
  1463.    any state we have built.  If not, then everything is going fine, and
  1464.    we should just hang loose
  1465.  */
  1466. {
  1467.   void* ptr = NULL;
  1468.   long i;
  1469.  
  1470.   if (buf == NULL)                        
  1471.    { s_free(seedWordsUsed);                
  1472.      if (docHeaders != NULL)                
  1473.        for (i = 0,ptr = (void *)docHeaders[i]; ptr != NULL; 
  1474.         ptr = (void *)docHeaders[++i])        
  1475.      freeWAISDocumentHeader((WAISDocumentHeader*)ptr);    
  1476.      s_free(docHeaders);                
  1477.      if (shortHeaders != NULL)    
  1478.        for (i = 0,ptr = (void *)shortHeaders[i]; ptr != NULL;
  1479.         ptr = (void *)shortHeaders[++i])    
  1480.      freeWAISDocumentShortHeader((WAISDocumentShortHeader*)ptr);
  1481.      s_free(shortHeaders);                        
  1482.      if (longHeaders != NULL)                
  1483.        for (i = 0,ptr = (void *)longHeaders[i]; ptr != NULL; 
  1484.         ptr = (void *)longHeaders[++i])    
  1485.      freeWAISDocumentLongHeader((WAISDocumentLongHeader*)ptr);
  1486.      s_free(longHeaders);                
  1487.      if (text != NULL)                    
  1488.        for (i = 0,ptr = (void *)text[i]; ptr != NULL; ptr = (void *)text[++i])
  1489.      freeWAISDocumentText((WAISDocumentText*)ptr);    
  1490.      s_free(text);                    
  1491.      if (headlines != NULL)                    
  1492.        for (i = 0,ptr = (void *)headlines[i]; ptr != NULL;
  1493.         ptr = (void *)headlines[++i])        
  1494.      freeWAISDocumentHeadlines((WAISDocumentHeadlines*)ptr);    
  1495.      s_free(headlines);                        
  1496.      if (codes != NULL)                     
  1497.        for (i = 0,ptr = (void *)codes[i]; ptr != NULL; 
  1498.         ptr = (void *)codes[++i])                
  1499.      freeWAISDocumentCodes((WAISDocumentCodes*)ptr);     
  1500.      s_free(codes);                    
  1501.      if (diags != NULL)                          
  1502.        for (i = 0,ptr = (void *)diags[i]; ptr != NULL; 
  1503.         ptr = (void *)diags[++i])     
  1504.      freeDiag((diagnosticRecord*)ptr);         
  1505.      s_free(diags);
  1506.    }
  1507. }
  1508.  
  1509. /*----------------------------------------------------------------------*/
  1510.  
  1511. char*
  1512. readSearchResponseInfo(info,buffer)
  1513. void** info;
  1514. char* buffer;
  1515. {
  1516.   char* buf = buffer;
  1517.   unsigned long size; 
  1518.   unsigned long headerSize;
  1519.   data_tag tag;
  1520.   void* header = NULL;
  1521.   WAISDocumentHeader** docHeaders = NULL;
  1522.   WAISDocumentShortHeader** shortHeaders = NULL;
  1523.   WAISDocumentLongHeader** longHeaders = NULL;
  1524.   WAISDocumentText** text = NULL;
  1525.   WAISDocumentHeadlines** headlines = NULL;
  1526.   WAISDocumentCodes** codes = NULL;
  1527.   long numDocHeaders,numLongHeaders,numShortHeaders,numText,numHeadlines;
  1528.   long numCodes;
  1529.   char* seedWordsUsed = NULL;
  1530.   diagnosticRecord** diags = NULL;
  1531.   diagnosticRecord* diag = NULL;
  1532.   long numDiags = 0;
  1533.   
  1534.   numDocHeaders = numLongHeaders = numShortHeaders = numText = numHeadlines = numCodes = 0;
  1535.   
  1536.   buf = readUserInfoHeader(&tag,&size,buf);
  1537.   headerSize = buf - buffer;
  1538.     
  1539.   while (buf < (buffer + size + headerSize))
  1540.    { data_tag tag = peekTag(buf);
  1541.      switch (tag)
  1542.       { case DT_SeedWordsUsed:
  1543.             buf = readString(&seedWordsUsed,buf);
  1544.             break;
  1545.           case DT_DatabaseDiagnosticRecords:
  1546.             if (diags == NULL) /* create a new diag list */
  1547.              { diags = (diagnosticRecord**)s_malloc((size_t)sizeof(diagnosticRecord*) * 2);
  1548.              }
  1549.             else /* grow the diag list */
  1550.              { diags = (diagnosticRecord**)s_realloc((char*)diags,(size_t)(sizeof(diagnosticRecord*) * (numDiags + 2)));
  1551.              }
  1552.             buf = readDiag(&diag,buf);
  1553.             diags[numDiags++] = diag; /* put it in the list */
  1554.             diags[numDiags] = NULL;
  1555.             break;
  1556.           case DT_DocumentHeaderGroup:
  1557.             if (docHeaders == NULL) /* create a new header list */
  1558.              { docHeaders = (WAISDocumentHeader**)s_malloc((size_t)sizeof(WAISDocumentHeader*) * 2);
  1559.              }
  1560.             else /* grow the doc list */
  1561.              { docHeaders = (WAISDocumentHeader**)s_realloc((char*)docHeaders,(size_t)(sizeof(WAISDocumentHeader*) * (numDocHeaders + 2)));
  1562.              }
  1563.             buf = readWAISDocumentHeader((WAISDocumentHeader**)&header,buf);
  1564.           cleanUpWaisSearchResponse(buf,seedWordsUsed,docHeaders,shortHeaders,longHeaders,text,headlines,codes,diags);
  1565.             RETURN_ON_NULL(buf);
  1566.             docHeaders[numDocHeaders++] = 
  1567.             (WAISDocumentHeader*)header; /* put it in the list */
  1568.             docHeaders[numDocHeaders] = NULL;
  1569.             break;
  1570.           case DT_DocumentShortHeaderGroup:
  1571.             if (shortHeaders == NULL) /* create a new header list */
  1572.              { shortHeaders = (WAISDocumentShortHeader**)s_malloc((size_t)sizeof(WAISDocumentShortHeader*) * 2);
  1573.              }
  1574.             else /* grow the doc list */
  1575.              { shortHeaders = (WAISDocumentShortHeader**)s_realloc((char*)shortHeaders,(size_t)(sizeof(WAISDocumentShortHeader*) * (numShortHeaders + 2)));
  1576.              }
  1577.             buf = readWAISDocumentShortHeader((WAISDocumentShortHeader**)&header,buf);
  1578.           cleanUpWaisSearchResponse(buf,seedWordsUsed,docHeaders,shortHeaders,longHeaders,text,headlines,codes,diags);
  1579.             RETURN_ON_NULL(buf);
  1580.             shortHeaders[numShortHeaders++] = 
  1581.             (WAISDocumentShortHeader*)header; /* put it in the list */
  1582.             shortHeaders[numShortHeaders] = NULL;
  1583.             break;
  1584.           case DT_DocumentLongHeaderGroup:
  1585.             if (longHeaders == NULL) /* create a new header list */
  1586.              { longHeaders = (WAISDocumentLongHeader**)s_malloc((size_t)sizeof(WAISDocumentLongHeader*) * 2);
  1587.              }
  1588.             else /* grow the doc list */
  1589.              { longHeaders = (WAISDocumentLongHeader**)s_realloc((char*)longHeaders,(size_t)(sizeof(WAISDocumentLongHeader*) * (numLongHeaders + 2)));
  1590.              }
  1591.             buf = readWAISDocumentLongHeader((WAISDocumentLongHeader**)&header,buf);
  1592.           cleanUpWaisSearchResponse(buf,seedWordsUsed,docHeaders,shortHeaders,longHeaders,text,headlines,codes,diags);
  1593.             RETURN_ON_NULL(buf);
  1594.             longHeaders[numLongHeaders++] = 
  1595.             (WAISDocumentLongHeader*)header; /* put it in the list */
  1596.             longHeaders[numLongHeaders] = NULL;
  1597.             break;
  1598.         case DT_DocumentTextGroup:
  1599.             if (text == NULL) /* create a new list */
  1600.              { text = (WAISDocumentText**)s_malloc((size_t)sizeof(WAISDocumentText*) * 2);
  1601.              }
  1602.             else /* grow the list */
  1603.              { text = (WAISDocumentText**)s_realloc((char*)text,(size_t)(sizeof(WAISDocumentText*) * (numText + 2)));
  1604.              }
  1605.             buf = readWAISDocumentText((WAISDocumentText**)&header,buf);
  1606.           cleanUpWaisSearchResponse(buf,seedWordsUsed,docHeaders,shortHeaders,longHeaders,text,headlines,codes,diags);
  1607.             RETURN_ON_NULL(buf);
  1608.             text[numText++] = 
  1609.             (WAISDocumentText*)header; /* put it in the list */
  1610.             text[numText] = NULL;
  1611.             break;
  1612.           case DT_DocumentHeadlineGroup:
  1613.             if (headlines == NULL) /* create a new list */
  1614.              { headlines = (WAISDocumentHeadlines**)s_malloc((size_t)sizeof(WAISDocumentHeadlines*) * 2);
  1615.              }
  1616.             else /* grow the list */
  1617.              { headlines = (WAISDocumentHeadlines**)s_realloc((char*)headlines,(size_t)(sizeof(WAISDocumentHeadlines*) * (numHeadlines + 2)));
  1618.              }
  1619.             buf = readWAISDocumentHeadlines((WAISDocumentHeadlines**)&header,buf);
  1620.           cleanUpWaisSearchResponse(buf,seedWordsUsed,docHeaders,shortHeaders,longHeaders,text,headlines,codes,diags);
  1621.             RETURN_ON_NULL(buf);
  1622.             headlines[numHeadlines++] = 
  1623.             (WAISDocumentHeadlines*)header; /* put it in the list */
  1624.             headlines[numHeadlines] = NULL;
  1625.             break;
  1626.           case DT_DocumentCodeGroup:
  1627.             if (codes == NULL) /* create a new list */
  1628.              { codes = (WAISDocumentCodes**)s_malloc((size_t)sizeof(WAISDocumentCodes*) * 2);
  1629.              }
  1630.             else /* grow the list */
  1631.              { codes = (WAISDocumentCodes**)s_realloc((char*)codes,(size_t)(sizeof(WAISDocumentCodes*) * (numCodes + 2)));
  1632.              }
  1633.             buf = readWAISDocumentCodes((WAISDocumentCodes**)&header,buf);
  1634.           cleanUpWaisSearchResponse(buf,seedWordsUsed,docHeaders,shortHeaders,longHeaders,text,headlines,codes,diags);
  1635.             RETURN_ON_NULL(buf);
  1636.             codes[numCodes++] = 
  1637.             (WAISDocumentCodes*)header; /* put it in the list */
  1638.             codes[numCodes] = NULL;
  1639.             break;
  1640.         default:
  1641.           cleanUpWaisSearchResponse(buf,seedWordsUsed,docHeaders,shortHeaders,longHeaders,text,headlines,codes,diags);
  1642.           REPORT_READ_ERROR(buf);
  1643.           break;
  1644.       }
  1645.    }
  1646.         
  1647.   *info = (void *)makeWAISSearchResponse(seedWordsUsed,docHeaders,shortHeaders,
  1648.                  longHeaders,text,headlines,codes,diags);
  1649.   
  1650.   return(buf);
  1651. }
  1652.  
  1653. /*----------------------------------------------------------------------*/
  1654.  
  1655. WAISDocumentText*
  1656. makeWAISDocumentText(docID,versionNumber,documentText)
  1657. any* docID;
  1658. long versionNumber;
  1659. any* documentText;
  1660. {
  1661.   WAISDocumentText* docText = (WAISDocumentText*)s_malloc((size_t)sizeof(WAISDocumentText));
  1662.  
  1663.   docText->DocumentID = docID;
  1664.   docText->VersionNumber = versionNumber;
  1665.   docText->DocumentText = documentText;
  1666.   
  1667.   return(docText);
  1668. }
  1669.  
  1670. /*----------------------------------------------------------------------*/
  1671.  
  1672. void 
  1673. freeWAISDocumentText(docText)
  1674. WAISDocumentText* docText;
  1675. {
  1676.   freeAny(docText->DocumentID);
  1677.   freeAny(docText->DocumentText);
  1678.   s_free(docText);
  1679. }
  1680.  
  1681. /*----------------------------------------------------------------------*/
  1682.  
  1683. char* 
  1684. writeWAISDocumentText(docText,buffer,len)
  1685. WAISDocumentText* docText;
  1686. char* buffer;
  1687. long* len;
  1688. {
  1689.   unsigned long header_len = userInfoTagSize(DT_DocumentTextGroup,
  1690.                                             DefWAISDocTextSize);
  1691.   char* buf = buffer + header_len;
  1692.   unsigned long size;
  1693.   
  1694.   RESERVE_SPACE_FOR_WAIS_HEADER(len);
  1695.  
  1696.   buf = writeAny(docText->DocumentID,DT_DocumentID,buf,len);
  1697.   buf = writeNum(docText->VersionNumber,DT_VersionNumber,buf,len);
  1698.   buf = writeAny(docText->DocumentText,DT_DocumentText,buf,len);
  1699.   
  1700.   /* now write the header and size */
  1701.   size = buf - buffer; 
  1702.   buf = writeUserInfoHeader(DT_DocumentTextGroup,size,header_len,buffer,len);
  1703.  
  1704.   return(buf);
  1705. }
  1706.  
  1707. /*----------------------------------------------------------------------*/
  1708.  
  1709. char* 
  1710. readWAISDocumentText(docText,buffer)
  1711. WAISDocumentText** docText;
  1712. char* buffer;
  1713. {
  1714.   char* buf = buffer;
  1715.   unsigned long size; 
  1716.   unsigned long headerSize;
  1717.   data_tag tag;
  1718.   any *docID,*documentText;
  1719.   long versionNumber;
  1720.   
  1721.   docID = documentText = NULL;
  1722.   versionNumber = UNUSED;
  1723.   
  1724.   buf = readUserInfoHeader(&tag,&size,buf);
  1725.   headerSize = buf - buffer;
  1726.     
  1727.   while (buf < (buffer + size + headerSize))
  1728.    { data_tag tag = peekTag(buf);
  1729.      switch (tag)
  1730.       { case DT_DocumentID:
  1731.             buf = readAny(&docID,buf);
  1732.             break;
  1733.           case DT_VersionNumber:
  1734.             buf = readNum(&versionNumber,buf);
  1735.             break;
  1736.           case DT_DocumentText:
  1737.             buf = readAny(&documentText,buf);
  1738.             break;
  1739.         default:
  1740.           freeAny(docID);
  1741.           freeAny(documentText);
  1742.           REPORT_READ_ERROR(buf);
  1743.           break;
  1744.       }
  1745.    }
  1746.         
  1747.   *docText = makeWAISDocumentText(docID,versionNumber,documentText);
  1748.   return(buf);
  1749. }
  1750.  
  1751. /*----------------------------------------------------------------------*/
  1752.  
  1753. WAISDocumentHeadlines*
  1754. makeWAISDocumentHeadlines(docID,
  1755.               versionNumber,
  1756.               source,
  1757.               date,
  1758.               headline,
  1759.               originCity)
  1760. any* docID;
  1761. long versionNumber;
  1762. char* source;
  1763. char* date;
  1764. char* headline;
  1765. char* originCity;
  1766. {
  1767.   WAISDocumentHeadlines* docHeadline =
  1768.     (WAISDocumentHeadlines*)s_malloc((size_t)sizeof(WAISDocumentHeadlines));
  1769.  
  1770.   docHeadline->DocumentID = docID;
  1771.   docHeadline->VersionNumber = versionNumber;
  1772.   docHeadline->Source = source;
  1773.   docHeadline->Date = date;
  1774.   docHeadline->Headline = headline;
  1775.   docHeadline->OriginCity = originCity;
  1776.   
  1777.   return(docHeadline);
  1778. }
  1779.  
  1780. /*----------------------------------------------------------------------*/
  1781.  
  1782. void 
  1783. freeWAISDocumentHeadlines(docHeadline)
  1784. WAISDocumentHeadlines* docHeadline;
  1785. {
  1786.   freeAny(docHeadline->DocumentID);
  1787.   s_free(docHeadline->Source);
  1788.   s_free(docHeadline->Date);
  1789.   s_free(docHeadline->Headline);
  1790.   s_free(docHeadline->OriginCity);
  1791.   s_free(docHeadline);
  1792. }
  1793.  
  1794. /*----------------------------------------------------------------------*/
  1795.  
  1796. char* 
  1797. writeWAISDocumentHeadlines(docHeadline,buffer,len)
  1798. WAISDocumentHeadlines* docHeadline;
  1799. char* buffer;
  1800. long* len;
  1801. {
  1802.   unsigned long header_len = userInfoTagSize(DT_DocumentHeadlineGroup,
  1803.                                             DefWAISDocHeadlineSize);
  1804.   char* buf = buffer + header_len;
  1805.   unsigned long size;
  1806.   
  1807.   RESERVE_SPACE_FOR_WAIS_HEADER(len);
  1808.  
  1809.   buf = writeAny(docHeadline->DocumentID,DT_DocumentID,buf,len);
  1810.   buf = writeNum(docHeadline->VersionNumber,DT_VersionNumber,buf,len);
  1811.   buf = writeString(docHeadline->Source,DT_Source,buf,len);
  1812.   buf = writeString(docHeadline->Date,DT_Date,buf,len);
  1813.   buf = writeString(docHeadline->Headline,DT_Headline,buf,len);
  1814.   buf = writeString(docHeadline->OriginCity,DT_OriginCity,buf,len);
  1815.   
  1816.   /* now write the header and size */
  1817.   size = buf - buffer; 
  1818.   buf = writeUserInfoHeader(DT_DocumentHeadlineGroup,size,header_len,buffer,len);
  1819.  
  1820.   return(buf);
  1821. }
  1822.  
  1823. /*----------------------------------------------------------------------*/
  1824.  
  1825. char* 
  1826. readWAISDocumentHeadlines(docHeadline,buffer)
  1827. WAISDocumentHeadlines** docHeadline;
  1828. char* buffer;
  1829. {
  1830.   char* buf = buffer;
  1831.   unsigned long size; 
  1832.   unsigned long headerSize;
  1833.   data_tag tag;
  1834.   any* docID;
  1835.   long versionNumber;
  1836.   char *source,*date,*headline,*originCity;
  1837.   
  1838.   docID = NULL;
  1839.   versionNumber = UNUSED;
  1840.   source = date = headline = originCity = NULL;
  1841.   
  1842.   buf = readUserInfoHeader(&tag,&size,buf);
  1843.   headerSize = buf - buffer;
  1844.     
  1845.   while (buf < (buffer + size + headerSize))
  1846.    { data_tag tag = peekTag(buf);
  1847.      switch (tag)
  1848.       { case DT_DocumentID:
  1849.             buf = readAny(&docID,buf);
  1850.             break;
  1851.           case DT_VersionNumber:
  1852.             buf = readNum(&versionNumber,buf);
  1853.             break;
  1854.           case DT_Source:
  1855.             buf = readString(&source,buf);
  1856.             break;
  1857.           case DT_Date:
  1858.             buf = readString(&date,buf);
  1859.             break;
  1860.           case DT_Headline:
  1861.             buf = readString(&headline,buf);
  1862.             break;
  1863.           case DT_OriginCity:
  1864.             buf = readString(&originCity,buf);
  1865.             break;
  1866.         default:
  1867.           freeAny(docID);
  1868.           s_free(source);
  1869.           s_free(date);
  1870.           s_free(headline);
  1871.           s_free(originCity);
  1872.           REPORT_READ_ERROR(buf);
  1873.           break;
  1874.       }
  1875.    }
  1876.         
  1877.   *docHeadline = makeWAISDocumentHeadlines(docID,versionNumber,source,date,
  1878.                                              headline,originCity);
  1879.   return(buf);
  1880. }
  1881.  
  1882. /*----------------------------------------------------------------------*/
  1883.  
  1884. WAISDocumentCodes*
  1885. makeWAISDocumentCodes(docID,
  1886.               versionNumber,
  1887.               stockCodes,
  1888.               companyCodes,
  1889.               industryCodes)
  1890. any* docID;
  1891. long versionNumber;
  1892. char* stockCodes;
  1893. char* companyCodes;
  1894. char* industryCodes;
  1895. {
  1896.   WAISDocumentCodes* docCodes = (WAISDocumentCodes*)s_malloc((size_t)sizeof(WAISDocumentCodes));
  1897.  
  1898.   docCodes->DocumentID = docID;
  1899.   docCodes->VersionNumber = versionNumber;
  1900.   docCodes->StockCodes = stockCodes;
  1901.   docCodes->CompanyCodes = companyCodes;
  1902.   docCodes->IndustryCodes = industryCodes;
  1903.   
  1904.   return(docCodes);
  1905. }
  1906.  
  1907. /*----------------------------------------------------------------------*/
  1908.  
  1909. void 
  1910. freeWAISDocumentCodes(docCodes)
  1911. WAISDocumentCodes* docCodes;
  1912. {
  1913.   freeAny(docCodes->DocumentID);
  1914.   s_free(docCodes->StockCodes);
  1915.   s_free(docCodes->CompanyCodes);
  1916.   s_free(docCodes->IndustryCodes);
  1917.   s_free(docCodes);
  1918. }
  1919.  
  1920. /*----------------------------------------------------------------------*/
  1921.  
  1922. char* 
  1923. writeWAISDocumentCodes(docCodes,buffer,len)
  1924. WAISDocumentCodes* docCodes;
  1925. char* buffer;
  1926. long* len;
  1927. {
  1928.   unsigned long header_len = userInfoTagSize(DT_DocumentCodeGroup ,
  1929.                                             DefWAISDocCodeSize);
  1930.   char* buf = buffer + header_len;
  1931.   unsigned long size;
  1932.   
  1933.   RESERVE_SPACE_FOR_WAIS_HEADER(len);
  1934.  
  1935.   buf = writeAny(docCodes->DocumentID,DT_DocumentID,buf,len);
  1936.   buf = writeNum(docCodes->VersionNumber,DT_VersionNumber,buf,len);
  1937.   buf = writeString(docCodes->StockCodes,DT_StockCodes,buf,len);
  1938.   buf = writeString(docCodes->CompanyCodes,DT_CompanyCodes,buf,len);
  1939.   buf = writeString(docCodes->IndustryCodes,DT_IndustryCodes,buf,len);
  1940.   
  1941.   /* now write the header and size */
  1942.   size = buf - buffer; 
  1943.   buf = writeUserInfoHeader(DT_DocumentCodeGroup,size,header_len,buffer,len);
  1944.  
  1945.   return(buf);
  1946. }
  1947.  
  1948. /*----------------------------------------------------------------------*/
  1949.  
  1950. char* 
  1951. readWAISDocumentCodes(docCodes,buffer)
  1952. WAISDocumentCodes** docCodes;
  1953. char* buffer;
  1954. {
  1955.   char* buf = buffer;
  1956.   unsigned long size; 
  1957.   unsigned long headerSize;
  1958.   data_tag tag;
  1959.   any* docID;
  1960.   long versionNumber;
  1961.   char *stockCodes,*companyCodes,*industryCodes;
  1962.   
  1963.   docID = NULL;
  1964.   versionNumber = UNUSED;
  1965.   stockCodes = companyCodes = industryCodes = NULL;
  1966.   
  1967.   buf = readUserInfoHeader(&tag,&size,buf);
  1968.   headerSize = buf - buffer;
  1969.     
  1970.   while (buf < (buffer + size + headerSize))
  1971.    { data_tag tag = peekTag(buf);
  1972.      switch (tag)
  1973.       { case DT_DocumentID:
  1974.             buf = readAny(&docID,buf);
  1975.             break;
  1976.           case DT_VersionNumber:
  1977.             buf = readNum(&versionNumber,buf);
  1978.             break;
  1979.           case DT_StockCodes:
  1980.             buf = readString(&stockCodes,buf);
  1981.             break;
  1982.           case DT_CompanyCodes:
  1983.             buf = readString(&companyCodes,buf);
  1984.             break;
  1985.           case DT_IndustryCodes:
  1986.             buf = readString(&industryCodes,buf);
  1987.             break;
  1988.         default:
  1989.           freeAny(docID);
  1990.           s_free(stockCodes);
  1991.           s_free(companyCodes);
  1992.           s_free(industryCodes);
  1993.           REPORT_READ_ERROR(buf);
  1994.           break;
  1995.       }
  1996.    }
  1997.         
  1998.   *docCodes = makeWAISDocumentCodes(docID,versionNumber,stockCodes,
  1999.                                       companyCodes,industryCodes);
  2000.   return(buf);
  2001. }
  2002.  
  2003. /*----------------------------------------------------------------------*/
  2004.  
  2005. char* 
  2006. writePresentInfo(present,buffer,len)
  2007. PresentAPDU* present;
  2008. char* buffer;
  2009. long* len;
  2010. {
  2011.   /* The WAIS protocol doesn't use present info */
  2012.   return(buffer);
  2013. }
  2014.  
  2015. /*----------------------------------------------------------------------*/
  2016.  
  2017. char* 
  2018. readPresentInfo(info,buffer)
  2019. void** info;
  2020. char* buffer;
  2021. {
  2022.   /* The WAIS protocol doesn't use present info */
  2023.   *info = NULL;
  2024.   return(buffer);
  2025. }
  2026.  
  2027. /*----------------------------------------------------------------------*/
  2028.  
  2029. char* 
  2030. writePresentResponseInfo(response,buffer,len)
  2031. PresentResponseAPDU* response;
  2032. char* buffer;
  2033. long* len;
  2034. {
  2035.   /* The WAIS protocol doesn't use presentResponse info */
  2036.   return(buffer);
  2037. }
  2038.  
  2039. /*----------------------------------------------------------------------*/
  2040.  
  2041. char* 
  2042. readPresentResponseInfo(info,buffer)
  2043. void** info;
  2044. char* buffer;
  2045. {
  2046.   /* The WAIS protocol doesn't use presentResponse info */
  2047.   *info = NULL;
  2048.   return(buffer);
  2049. }
  2050.  
  2051. /*----------------------------------------------------------------------*/
  2052.  
  2053. /* support for type 1 queries */
  2054.  
  2055. /* new use values (for the chunk types) */
  2056. #define    BYTE        "wb"
  2057. #define    LINE        "wl"
  2058. #define    PARAGRAPH    "wp"
  2059. #define DATA_TYPE    "wt"
  2060.  
  2061. /* WAIS supports the following semantics for type 1 queries:
  2062.        
  2063.      1.  retrieve the header/codes from a document:
  2064.  
  2065.             System_Control_Number = docID
  2066.             Data Type = type (optional)
  2067.             And
  2068.  
  2069.      2.  retrieve a fragment of the text of a document:
  2070.  
  2071.             System_Control_Number = docID
  2072.             Data Type = type (optional)
  2073.             And
  2074.             Chunk >= start
  2075.             And
  2076.             Chunk < end
  2077.             And
  2078.  
  2079.            Information from multiple documents may be requested by using 
  2080.            groups of the above joined by:
  2081.  
  2082.             OR
  2083.  
  2084.            ( XXX does an OR come after every group but the first, or do they
  2085.               all come at the end? )
  2086.               
  2087.         ( XXX return type could be in the element set)
  2088. */
  2089.  
  2090. static query_term** makeWAISQueryTerms _AP((DocObj** docs));
  2091.    
  2092. static query_term**
  2093. makeWAISQueryTerms(docs)
  2094. DocObj** docs;
  2095. /* given a null terminated list of docObjs, construct the appropriate
  2096.    query of the form given above
  2097.  */
  2098. {
  2099.   query_term** terms = NULL;
  2100.   long numTerms = 0;
  2101.   DocObj* doc = NULL;
  2102.   long i;
  2103.  
  2104.   if (docs == NULL)
  2105.     return((query_term**)NULL);
  2106.  
  2107.   terms = (query_term**)s_malloc((size_t)(sizeof(query_term*) * 1));
  2108.   terms[numTerms] = NULL;
  2109.  
  2110.   /* loop through the docs making terms for them all */
  2111.   for (i = 0,doc = docs[i]; doc != NULL; doc = docs[++i])
  2112.     { any* type = NULL;
  2113.  
  2114.       if (doc->Type != NULL)
  2115.     type = stringToAny(doc->Type);
  2116.  
  2117.       if (doc->ChunkCode == CT_document) /* a whole document */
  2118.     { terms = (query_term**)s_realloc((char*)terms,
  2119.                       (size_t)(sizeof(query_term*) * 
  2120.                            (numTerms + 3 + 1)));
  2121.       terms[numTerms++] = makeAttributeTerm(SYSTEM_CONTROL_NUMBER,
  2122.                         EQUAL,IGNORE,IGNORE,
  2123.                         IGNORE,IGNORE,doc->DocumentID);
  2124.       if (type != NULL)
  2125.        { terms[numTerms++] = makeAttributeTerm(DATA_TYPE,EQUAL,
  2126.                            IGNORE,IGNORE,IGNORE,
  2127.                            IGNORE,type);
  2128.          terms[numTerms++] = makeOperatorTerm(AND);
  2129.            }
  2130.       terms[numTerms] = NULL;
  2131.     }
  2132.       else            /* a document fragment */
  2133.     {    char chunk_att[ATTRIBUTE_SIZE];
  2134.         any* startChunk = NULL;
  2135.         any* endChunk = NULL;
  2136.  
  2137.         terms = (query_term**)s_realloc((char*)terms,
  2138.                         (size_t)(sizeof(query_term*) * 
  2139.                              (numTerms + 7 + 1)));
  2140.  
  2141.         switch (doc->ChunkCode)
  2142.           { case CT_byte:
  2143.             case CT_line:
  2144.               { char start[20],end[20];
  2145.             (doc->ChunkCode == CT_byte) ?
  2146.               strncpy(chunk_att,BYTE,ATTRIBUTE_SIZE) :
  2147.             strncpy(chunk_att,LINE,ATTRIBUTE_SIZE);    
  2148.             sprintf(start,"%ld",doc->ChunkStart.Pos);
  2149.             startChunk = stringToAny(start);
  2150.             sprintf(end,"%ld",doc->ChunkEnd.Pos);
  2151.             endChunk = stringToAny(end);
  2152.               }
  2153.               break;
  2154.             case CT_paragraph:
  2155.               strncpy(chunk_att,PARAGRAPH,ATTRIBUTE_SIZE);
  2156.               startChunk = doc->ChunkStart.ID;
  2157.               endChunk = doc->ChunkEnd.ID;
  2158.               break;
  2159.             default:
  2160.               /* error */
  2161.               break;
  2162.             }
  2163.  
  2164.         terms[numTerms++] = makeAttributeTerm(SYSTEM_CONTROL_NUMBER,
  2165.                               EQUAL,IGNORE,IGNORE,
  2166.                               IGNORE,
  2167.                               IGNORE,doc->DocumentID);
  2168.         if (type != NULL)
  2169.          { terms[numTerms++] = makeAttributeTerm(DATA_TYPE,EQUAL,IGNORE,
  2170.                              IGNORE,IGNORE,IGNORE,
  2171.                              type);
  2172.            terms[numTerms++] = makeOperatorTerm(AND);
  2173.          }
  2174.         terms[numTerms++] = makeAttributeTerm(chunk_att,
  2175.                               GREATER_THAN_OR_EQUAL,
  2176.                               IGNORE,IGNORE,IGNORE, 
  2177.                               IGNORE,
  2178.                               startChunk);
  2179.         terms[numTerms++] = makeOperatorTerm(AND);
  2180.         terms[numTerms++] = makeAttributeTerm(chunk_att,LESS_THAN,
  2181.                               IGNORE,IGNORE,IGNORE,
  2182.                               IGNORE,
  2183.                               endChunk);
  2184.         terms[numTerms++] = makeOperatorTerm(AND);
  2185.         terms[numTerms] = NULL;
  2186.  
  2187.         if (doc->ChunkCode == CT_byte || doc->ChunkCode == CT_line)
  2188.           { freeAny(startChunk);
  2189.             freeAny(endChunk);
  2190.           }
  2191.           }
  2192.       
  2193.       freeAny(type);
  2194.       
  2195.      if (i != 0) /* multiple independent queries, need a disjunction */
  2196.     { terms = (query_term**)s_realloc((char*)terms,
  2197.                       (size_t)(sizeof(query_term*) * 
  2198.                            (numTerms + 1 + 1)));
  2199.       terms[numTerms++] = makeOperatorTerm(OR);
  2200.       terms[numTerms] = NULL;
  2201.     }
  2202.     }
  2203.  
  2204.   return(terms);
  2205. }
  2206.  
  2207. /*----------------------------------------------------------------------*/
  2208.  
  2209. static DocObj** makeWAISQueryDocs _AP((query_term** terms));
  2210.  
  2211. static DocObj** 
  2212. makeWAISQueryDocs(terms)
  2213. query_term** terms;
  2214. /* given a list of terms in the form given above, convert them to 
  2215.    DocObjs.
  2216.  */
  2217. {
  2218.   query_term* docTerm = NULL;
  2219.   query_term* fragmentTerm = NULL;
  2220.   DocObj** docs = NULL;
  2221.   DocObj* doc = NULL;
  2222.   long docNum,termNum;
  2223.  
  2224.   docNum = termNum = 0;
  2225.   
  2226.   docs = (DocObj**)s_malloc((size_t)(sizeof(DocObj*) * 1));
  2227.   docs[docNum] = NULL;
  2228.  
  2229.   /* translate the terms into DocObjs */
  2230.   while (true)
  2231.     {          
  2232.       query_term* typeTerm = NULL;
  2233.       char* type = NULL;
  2234.       long startTermOffset;
  2235.  
  2236.       docTerm = terms[termNum];
  2237.      
  2238.       if (docTerm == NULL)
  2239.     break;            /* we're done converting */;
  2240.  
  2241.       typeTerm = terms[termNum + 1]; /* get the lead Term if it exists */
  2242.  
  2243.       if (strcmp(typeTerm->Use,DATA_TYPE) == 0)    /* we do have a type */
  2244.        { startTermOffset = 3;    
  2245.      type = anyToString(typeTerm->Term);
  2246.        }
  2247.       else                        /* no type */
  2248.        { startTermOffset = 1;
  2249.      typeTerm = NULL;
  2250.      type = NULL;
  2251.        }
  2252.  
  2253.       /* grow the doc list */
  2254.       docs = (DocObj**)s_realloc((char*)docs,(size_t)(sizeof(DocObj*) * 
  2255.                               (docNum + 1 + 1)));
  2256.  
  2257.       /* figure out what kind of docObj to build - and build it */
  2258.       fragmentTerm = terms[termNum + startTermOffset];
  2259.       if (fragmentTerm != NULL && fragmentTerm->TermType == TT_Attribute)
  2260.     {            /* build a document fragment */
  2261.       query_term* startTerm = fragmentTerm;
  2262.       query_term* endTerm = terms[termNum + startTermOffset + 2]; 
  2263.  
  2264.       if (strcmp(startTerm->Use,BYTE) == 0) /* a byte chunk */
  2265.         doc = makeDocObjUsingBytes(duplicateAny(docTerm->Term),
  2266.                        type,
  2267.                        anyToLong(startTerm->Term),
  2268.                        anyToLong(endTerm->Term));
  2269.       else if (strcmp(startTerm->Use,LINE) == 0) /* a line chunk */
  2270.         doc = makeDocObjUsingLines(duplicateAny(docTerm->Term),
  2271.                        type,
  2272.                        anyToLong(startTerm->Term),
  2273.                        anyToLong(endTerm->Term));
  2274.       else            /* a paragraph chunk */
  2275.         doc = makeDocObjUsingParagraphs(duplicateAny(docTerm->Term),
  2276.                         type,
  2277.                         duplicateAny(startTerm->Term),
  2278.                         duplicateAny(endTerm->Term));
  2279.       termNum += (startTermOffset + 4);    /* point to next term */
  2280.     }
  2281.       else            /* build a full document */
  2282.     { 
  2283.       doc = makeDocObjUsingWholeDocument(duplicateAny(docTerm->Term),
  2284.                          type);
  2285.       termNum += startTermOffset;    /* point to next term */
  2286.     }
  2287.      
  2288.       docs[docNum++] = doc;    /* insert the new document */
  2289.      
  2290.       docs[docNum] = NULL;    /* keep the doc list terminated */
  2291.  
  2292.      
  2293.       if (terms[termNum] != NULL)
  2294.     termNum++; /* skip the OR operator it necessary */
  2295.       else
  2296.     break; /* we are done */
  2297.     }
  2298.  
  2299.   return(docs);
  2300. }
  2301.  
  2302. /*----------------------------------------------------------------------*/
  2303.  
  2304. any* 
  2305. makeWAISTextQuery(docs)
  2306. DocObj** docs;
  2307. /* given a list of DocObjs, return an any whose contents is the corresponding
  2308.    type 1 query
  2309.  */
  2310. {
  2311.   any *buf = NULL;
  2312.   query_term** terms = NULL;
  2313.   
  2314.   terms = makeWAISQueryTerms(docs);
  2315.   buf = writeQuery(terms);
  2316.   
  2317.   doList((void**)terms,freeTerm);
  2318.   s_free(terms);
  2319.   
  2320.   return(buf);
  2321. }
  2322.  
  2323. /*----------------------------------------------------------------------*/
  2324.  
  2325. DocObj** 
  2326. readWAISTextQuery(buf)
  2327. any* buf;
  2328. /* given an any whose contents are type 1 queries of the WAIS sort, 
  2329.    construct a list of the corresponding DocObjs
  2330.  */
  2331. {
  2332.   query_term** terms = NULL;
  2333.   DocObj** docs = NULL;
  2334.   
  2335.   terms = readQuery(buf);
  2336.   docs = makeWAISQueryDocs(terms);
  2337.   
  2338.   doList((void**)terms,freeTerm);
  2339.   s_free(terms);
  2340.   
  2341.   return(docs);
  2342. }
  2343.  
  2344. /*----------------------------------------------------------------------*/
  2345. /* Customized free WAIS object routines:                                */
  2346. /*                                                                      */
  2347. /*   This set of procedures is for applications to free a WAIS object   */
  2348. /*   which was made with makeWAISFOO.                                   */
  2349. /*   Each procedure frees only the memory that was allocated in its     */
  2350. /*   associated makeWAISFOO routine, thus it's not necessary for the    */
  2351. /*   caller to assign nulls to the pointer fields of the WAIS object.  */
  2352. /*----------------------------------------------------------------------*/
  2353.  
  2354. void 
  2355. CSTFreeWAISInitResponse(init)
  2356. WAISInitResponse* init;
  2357. /* free an object made with makeWAISInitResponse */
  2358. {
  2359.   s_free(init);
  2360. }
  2361.  
  2362. /*----------------------------------------------------------------------*/
  2363.  
  2364. void 
  2365. CSTFreeWAISSearch(query)
  2366. WAISSearch* query;
  2367. /* destroy an object made with makeWAISSearch() */
  2368. { 
  2369.   s_free(query);
  2370. }
  2371.  
  2372. /*----------------------------------------------------------------------*/
  2373.  
  2374. void
  2375. CSTFreeDocObj(doc)
  2376. DocObj* doc;
  2377. /* free a docObj */
  2378. { 
  2379.     s_free(doc);
  2380. }
  2381.  
  2382. /*----------------------------------------------------------------------*/
  2383.  
  2384. void
  2385. CSTFreeWAISDocumentHeader(header)
  2386. WAISDocumentHeader* header;
  2387. { 
  2388.     s_free(header);
  2389. }
  2390.  
  2391. /*----------------------------------------------------------------------*/
  2392.  
  2393. void
  2394. CSTFreeWAISDocumentShortHeader(header)
  2395. WAISDocumentShortHeader* header;
  2396. { 
  2397.   s_free(header);
  2398. }
  2399. /*----------------------------------------------------------------------*/
  2400.  
  2401. void
  2402. CSTFreeWAISDocumentLongHeader(header)
  2403. WAISDocumentLongHeader* header;
  2404. {
  2405.   s_free(header);
  2406. }
  2407.  
  2408. /*----------------------------------------------------------------------*/
  2409.  
  2410. void
  2411. CSTFreeWAISSearchResponse(response)
  2412. WAISSearchResponse* response;
  2413. { 
  2414.   s_free(response);
  2415. }
  2416.  
  2417. /*----------------------------------------------------------------------*/
  2418.  
  2419. void 
  2420. CSTFreeWAISDocumentText(docText)
  2421. WAISDocumentText* docText;
  2422. { 
  2423.   s_free(docText);
  2424. }
  2425.  
  2426. /*----------------------------------------------------------------------*/
  2427.  
  2428. void 
  2429. CSTFreeWAISDocumentHeadlines(docHeadline)
  2430. WAISDocumentHeadlines* docHeadline;
  2431. { 
  2432.   s_free(docHeadline);
  2433. }
  2434.  
  2435. /*----------------------------------------------------------------------*/
  2436.  
  2437. void 
  2438. CSTFreeWAISDocumentCodes(docCodes)
  2439. WAISDocumentCodes* docCodes;
  2440. {
  2441.   s_free(docCodes);
  2442. }
  2443.  
  2444. /*----------------------------------------------------------------------*/
  2445.  
  2446. void 
  2447. CSTFreeWAISTextQuery(query)
  2448. any* query;
  2449. {
  2450.    freeAny(query);
  2451. }
  2452.  
  2453. /*----------------------------------------------------------------------*/
  2454.